home *** CD-ROM | disk | FTP | other *** search
/ MacWorld 1999 February / Macworld (1999-02).dmg / Serious Demos / XTension demo / XTension manual 2.0 / XTension manual 2.0.rsrc / TEXT_131.txt < prev    next >
Text File  |  1998-07-18  |  5KB  |  127 lines

  1.  
  2. Getting started                                          
  3.  
  4. If you don‚Äôt read manuals:
  5.  
  6. ‚Ä¢ Do read the ‚ÄúWhat you need‚Äù section.
  7.  
  8. ‚Ä¢ Do look at some example scripts, and notice the dictionary.
  9.   (Use the Script Editor to view it if you don't want to read it here)
  10.  
  11. ‚Ä¢ Browse some of the menus, buttons and scripts of the Demo
  12.     database.  
  13.  
  14. ‚Ä¢ Read the next chapter on Just the Facts.  If you understand it,
  15.     then you are on your way.  Otherwise, study the manual,
  16.     and the tutorials and articles on the website (www.shed.com).
  17.  
  18. ‚Ä¢ PLEASE Note that XTension must be active at all times. 
  19.    If you shut down your Mac, XTension cannot function. 
  20.  
  21. ‚Ä¢ XTension does not download to the CM11A or the CP290.
  22.  
  23. ‚Ä¢ Black and white versions of XTension are not as 'pretty',
  24.    but you can run a monitor copy of XTension on another
  25.    Mac via your network, and use the big screen/horsepower
  26.    when you want to see all the spiffy icons etc.
  27.  
  28. ‚Ä¢ Please do not use the Demo Database as the foundation of 
  29.     your system.  Always start with a 'fresh' database.
  30.  
  31. What you need
  32.  
  33. ‚Ä¢  Macintosh running System 7.1 or later with AppleScript, and the Serial Tool.  AppleScript and the Serial Tool may not have been loaded on your machine with your last system update.
  34.  
  35. ‚Ä¢ One of the supported X-10 interfaces :
  36. This is a small box which makes it easier for the host Macintosh to send and receive X-10 messages to and from the power bus:
  37.  
  38. ‚Ä¢  'ActiveHome'  interface (CM11A) from X-10 (USA).
  39.      The CM10A may also be used interchangeably.
  40.      XTension does not support download to the CM11A.
  41.      (The CM11a is sold under many brand names, but all look alike)
  42.  
  43. ‚Ä¢  'CP290'  interface from X-10 (USA).
  44.      XTension does not support download to the CP290.
  45.  
  46. ‚Ä¢  'LynX-10'  interface from Marrick Ltd.
  47.      XTension does not yet support all functions of the 'LynX-Port'.
  48.  
  49. ‚Ä¢   the "Two-Way"  interface from Home Intelligence Corp.
  50.   
  51.  
  52. ‚Ä¢ Serial cable
  53.  
  54. The package you purchased includes a serial cable for connecting the Macintosh to your chosen interface.  See the tech notes chapter if you want to build your own cable.
  55.  
  56. Note that the cable that comes with XTension plugs in to the
  57. end of the cable that comes with the CM11.
  58.  
  59. ‚Ä¢  TW-523 from X-10 Powerhouse will also be necessary for the LynX models and the "Two-Way".
  60.  
  61. ‚Ä¢  X-10 devices
  62.  
  63. Any device which sends or receives X-10 commands, will work with XTension.
  64.  
  65.  
  66. Making the connection
  67.  
  68. ‚Ä¢ If you have a LynX or "Two-Way" interface :
  69.  
  70. ‚Ä¢ Plug in TW-523 to a wall socket near the 'LynX' or the "Two-Way"
  71. ‚Ä¢ Connect the TW-523 cable to the interface.
  72. ‚Ä¢ Connect the serial cable between the Macintosh serial port and the interface.
  73.  
  74. ‚Ä¢ If you have a CM11A or CP290 interface :
  75.  
  76. ‚Ä¢ Plug in the interface to a wall socket near your Macintosh.
  77. ‚Ä¢ Plug in the serial cable between the interface and the Mac.
  78.   ( DO NOT put the batteries in, you don't need them)
  79. (   You do not need the TW-523  with either of these )
  80.  
  81.  
  82. ‚Ä¢ For all interfaces :
  83.  
  84. XTension will default to the known best settings on the 'modem' port, according to the type of interface. Take care that you do not change these unless you are sure ...
  85.  
  86. You can select either the Printer or Modem port, however, if you choose the Printer port, make sure that AppleTalk is turned off
  87. or is not using that port.
  88.  
  89.  
  90. Set up the program
  91.  
  92. The System Folder of the Macintosh must contain the  AppleScript Extension file as well as the Serial Tool.  You may also want to add the  AppleScript Scripting Additions folder to the Extensions folder
  93.  
  94. If these are not installed, you will get a warning and XTension can not start up.
  95.  
  96. You can easily install AppleScript and the Serial Tool from the file included on the disk.  It may need to be unstuffed, but you should just have to move them into the Extensions folder of your System Folder.
  97.  
  98. ( You will have to restart your Mac after installing AppleScript. )
  99.  
  100.  
  101. The installation diskette for XTension contains all items necessary, and needs only to be copied to your hard disk.  If you just drag the icon of the diskette onto your hard disk, it will create a folder called XTension... 
  102. After installation, the XTension folder should contain the following  items:
  103.  
  104.                     ‚Ä¢  XTension : the program
  105.                     ‚Ä¢  XTension Icons : the file
  106.                     ‚Ä¢  XTension DEMO database file
  107.                     ‚Ä¢  XTension electronic manual
  108.                     ‚Ä¢  Some example scripts
  109.                     ‚Ä¢  A stuffed file of AppleScript and the Serial Tool
  110.  
  111.  
  112. The first time you run XTension, you will be asked to insert your original installation diskette.  Thereafter, you will not be bothered unless something 'fishy' occurs.  ( ignore for freeware version )
  113.  
  114. Note that license to XTension allows multiple copies in a single household for a single interface type.
  115.  
  116. XTension will create other files and  folders in the XTension folder after the first time that you run the program :
  117.  
  118.                     ‚Ä¢  Database Backup      : a copy of the database
  119.                     ‚Ä¢  XTension Log                :  the log files of XTension  activity
  120.                     ‚Ä¢  Scripts folder             :  where text copies of  scripts are kept
  121.                     ‚Ä¢  Logs folder                    :  where activity logs are archived
  122.  
  123. In addition, XTension creates and maintains a  XTension Preferences file in the Preferences folder within  your System Folder.
  124.  
  125.  
  126.  
  127.